webPlug documentation: Using webPlug

An HTML editor for the Amiga

Using webPlug

Is not the intention of this document to teach you how to create your own HTML pages... You should know HTML to use webPlug. Anyway, learning HTML while using webPlug is easier.
This is why this doc only explains the features of webPlug. You should know the use of every HTML tag.
In a near future, my homepage will include a list of links to web-pages that teach HTML (spanish and english). If you know of one of these pages, please let me know.

General notes before starting.
webPlug's functions
webPlug's menues
Sending documents to browsers (Using BrowserLinks)

Main Index

Some general notes before starting...

The 'Add <BR>' checkmark found in most windows makes webPlug authomagically add a <BR> (Force return) after each tag added.<BR>This only works in tags that aren't 'single' tags ( <BR>, <LI> and so are 'single' tags).
The 'Cut & Paste' checkmark makes webPlug use the clipboard. For example, you want to make a sentence bold. Simply mark it in your text editor and select the 'Bold' entry in the styles list. webPlug will do the rest.
Some windows contain lists of tags (for example, the format window). Double-clicking an item of these lists is like selecting it and pressing Insert. If the item is in Italics, double-clicking it will open a window with some options for the tag.
Because of it's nature, no more than one copy of the program can be execute every time.

Go to top.

webPlug's functions

webPlug's functions are accessible via the functions menu or via the 'Toolbar'. This toolbar contains image buttons that give access to nearly all it's features.
Each button opens a window that contains the gadgets necessary to create a part of the HTML doc.

Here you'll find information about these functions (from left to right, in order):

Translation: This function will translate the ASCII chars to its' HTML equivalent. Simply mark a block of text and press 'Translate'. After a while (if the text is large), the text will appear translated.
With version v1.45 you can specify which chars you don't want to translate by simply typing them in the stringgadget. The 'HTML' button simply adds the common chars in HTML docs '<>&"'.
Info / HTML header: This GUI will insert the HTML header information for the document. Simply type the title (that will be translated) and press 'Insert'.
You can set the BaseFont and you can decide if you want the '<BODY> </BODY>' tags to be inserted or not (you can add them late with the Background function).
Is possible to add some information about the author of the document. This information is inserted as comments in the document.
Styles window: Nothing to explain here. Just mark a block of text and insert a style.
Supports Drag'n'Drop to the TextEditor.
Format window: Contains a list of formatting HTML tags. Simply select a tag, an alignment an go ! :-)
Supports Drag'n'Drop to the TextEditor.
Images window: This window offers a GUI to insert images into your document. When you load a document (or save it), the path is automatically copied into the image filename string gadget.
Pressing 'Show' will cause webPlug to display the image (using Datatypes or an external viewer. See Configuration.)
When specifying a new image, you'll see that webPlug's window gets busy. This is because the program is using Datatypes to know the size of the image and set it in the window. Of course, this will only happen for kickstart v39+; anyway, the size could be manually modified later. Kick 36/37 users will have to do it this way.
Forms window: The forms window allows you to create any form in HTML. Is divided in 2 register-pages, Form and Input. 'Forms' contains the data of the
tag. The Input page contains a list of all possible inputs. Double-click any entry to open the config window for the input.
Only a note: The Select Item (Option) window contains an 'Automatic generation' tool. It will generate automatically the number of options you want.
Supports Drag'n'Drop to the TextEditor.

List window

Nothing to explain here. Just mark a block of text and insert a list tag. Future versions of webPlug will offer some kind of automatic generation for lists.
Supports Drag'n'Drop to the TextEditor.

Background window

Here you can specify all the tags concerning the background of the page. The 'Show' button will make webPlug display the background image you have selected.
If you want to specify a color, just activate it (by selecting the checkmark) and click on the popup-image. The color requester will appear.

Tables window

This page contains the GUI to create tables. It features an automatic generation of tables. If you want, a number will be introduced in each cel (-1 if it's a header cell).
The parameters of each automatically generated cell are taken from current settings...
Supports Drag'n'Drop to the TextEditor.

Links window

Here you can specify an HTML link. Simply type in the 'Link to' field where do you want the link to point to, mark a block and type insert.

Custom Tags/Strings window

webPlug supports user-configurable HTML tags and strings. This function opens a window that includes 2 lists, Custom Tags and Custom Strings.
You can define a new custom tag (Button New) and then edit it. A CTag consists on a comment, the start tag and the end tag. These tags behave exactly as webPlug's internal ones. Of course, you can use Drag'n'Drop to apply them.

This function also includes Custom Strings. A custom string is just a string that you can add to the text, for example, a URL that you use very often. The custom strings can be dragged and dropped on the TextEditor, or on any string-gadget of webPlug.

Frames window

This button opens the Frames window. By now it is very basic, i.e., it doesn't feature a WYS frame editor (planned for v2.x), but it helps when creating framesets.
Plugins window

webPlug's functionality can be expanded using plugins. A plugin is a separated file (a shared library, located in the webplugins directory) which interfaces with webPlug, so it have some degree of control over it. Each plugin can have a window with its' own interface.
To open a plugin, just double click it's name in the list.
List window: Nothing to explain here. Just mark a block of text and insert a list tag. Future versions of webPlug will offer some kind of automatic generation for lists.
Supports Drag'n'Drop to the TextEditor.
Background window: Here you can specify all the tags concerning the background of the page. The 'Show' button will make webPlug display the background image you have selected.
If you want to specify a color, just activate it (by selecting the checkmark) and click on the popup-image. The color requester will appear.
Tables window: This page contains the GUI to create tables. It features an automatic generation of tables. If you want, a number will be introduced in each cel (-1 if it's a header cell).
The parameters of each automatically generated cell are taken from current settings...
Supports Drag'n'Drop to the TextEditor.
Links window: Here you can specify an HTML link. Simply type in the 'Link to' field where do you want the link to point to, mark a block and type insert.
Custom Tags/Strings window: webPlug supports user-configurable HTML tags and strings. This function opens a window that includes 2 lists, Custom Tags and Custom Strings.
You can define a new custom tag (Button New) and then edit it. A CTag consists on a comment, the start tag and the end tag. These tags behave exactly as webPlug's internal ones. Of course, you can use Drag'n'Drop to apply them.

This function also includes Custom Strings. A custom string is just a string that you can add to the text, for example, a URL that you use very often. The custom strings can be dragged and dropped on the TextEditor, or on any string-gadget of webPlug.
Frames window: This button opens the Frames window. By now it is very basic, i.e., it doesn't feature a WYS frame editor (planned for v2.x), but it helps when creating framesets.
Plugins window: webPlug's functionality can be expanded using plugins. A plugin is a separated file (a shared library, located in the webplugins directory) which interfaces with webPlug, so it have some degree of control over it. Each plugin can have a window with its' own interface.
To open a plugin, just double click it's name in the list.

Go to top.

Menus

Althoug the toolbar gives you access to all the tags that webPlug handle, a lot more functions are accessible through the program's menu. Here goes an small description of what you'll find:

Project
- New: Creates a new empty doc
- Load HTML/Text: Pops up an ASL requester. You can select any file (or multiple files with multiselect) and load it into the editor. webPlug will create new documents if necessary
- Save: Saves the current doc. If it doesn't have a name, the Save As function is invoked
- Save As: Saves the current doc with a new name
- Save All: Saves all the loaded documents. If one does not have a filename, webPlug will pop up an ASL requester
- Close: Close the current doc.
Edit
- Undo: Recover the text from the undo buffer
- Redo: Redoes the last action
- Cut/Copy Block: Cuts/Copies the selected block into the clipboard.
- Paste block: Pastes the contents of the clipboard into the texteditor.
- Mark Location X: Stores the current cursor position. You can store up to 5 positions for each doc.
- Go to location X: Sets the cursor position to the one stored with Mark Location.
- Block between 1 & 2: Selects the block of text present between the positions 1 and 2.
- Indent: This function adds 4 spaces at the begining of every selected line. Helps a lot to make the code more readable.
- Search: The search function. It allows you to find any string (even a multiple-line one) in the current text. If webPlug cannot find it in the cuurent text, you can tell it to continue the search in the following documents (Search in this document/in all the documents from this one).
  The search can be also Case sensitive, and webPlug can translate the special-chars of your string to the ISO-Latin standard before starting the search.
- Replace: Is similar to the Search function, but allows you to replace the found text with another text. You can replace all the occurrences at once (Replace All) or one by one.
- Block to find buffers: This function extracts the selected block of text and copies the contents into the find buffers of the Seach/Replace functions.
- Block to replace buffer: This function extracts the selected block of text and copies the contents into the replace buffers of the Replace function.

Go to top.

Sending the doc to a browser...

webPlug is not a WYSIWYG program. This means that you have no inmediate visual result of what you're doing.
To 'solve' somehow this problem, webPlug features the BrowserLinks. A BrowserLink is simply a shared library that teaches it how to communicate to a given WWW-browser via its' ARexx port. This way, you can edit the HTML document, and send it to a browser to test it with a single mouse click.

By now the following browsers are supported:

AMosaic (tested with v1.2)

Setting a BrowserLink...: BrowserLinks teach webPlug how to communicate with a WWW browser. You have to tell webPlug which browser will you use by setting the appropiate BrowserLink. Simply go to the prefs window and specify the full path of the BrowserLink..
You have to set the full path of the browser, too, so webPlug can find it when you want to run it.
Running the selected browser: If you have specified the full path of your browser, you can execute it by selecting the 'Browser/Run browser' menu or by clicking the 1st button (from left to right) in the Browser Window.. Then, webPlug will try to execute it and will wait for the browser's ARexx port.
If for any reason the browser is not loaded, you can cancel the wait by simply clicking 'Cancel' on the load window.
Please note that if the browser is already loaded and you want to use it with webPlug you have to select 'Browser/Run browser' anyway. In this case, webPlug will not load the browser, of course; it will load the BrowserLink only.
Actually sending it...: Simply select the menu 'Send to browser' or click on the 2nd button (from left to right) in the Browser window, if you send it for the first time, and 'Reload document' if it is not the case.
If the browser supports it, and you've set the 'Bring browser to front/back' option in the prefs, the browser's screen will become the frontmost.

Go to top.

As of v1.3+, webPlug can handle any number of documents (memory permitting :) at the same time. You can easily switch from a document to another by simply selecting the desired document in the listview that you can open using the 'Document' button of the editor's window.

webPlug can remember 5 locations in each document. This way, you don't have to search an search for a given position in the document. Just 'Mark' it (using the Edit/Mark) menu and return to this point at any time (by using the Edit/Go to menu).

From v1.2+, webPlug features Drag'n'Drop support for it's listviews. Simply select a tag (from any window) and drop it on the TextEditor. It will be inserted as if you pressed 'Insert' (that's the reason why the 'Insert' buttons can be hidden in this version).

webPlug includes a 'Search' function. It will search (case insensitive) for a given string all over the document. You can even make webPlug select (mark or block :-) the found string, so you can easily add tags to it.
The string you want to find is "translated" (to ISO-chars).

Go to top.